home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1992 June: ROMin Holiday / ADC Developer CD (1992-06) (''ROMin Holiday'')_iso / Developer Connection - 06-1992.iso / Development Platforms / Apple II / Essentials / Technical.Notes / PDOS / TN.PDOS.001 next >
Encoding:
Text File  |  1988-12-15  |  2.1 KB  |  51 lines  |  [TEXT/pdos]
  1. Apple II
  2. Technical Notes
  3. _____________________________________________________________________________
  4.                                                   Developer Technical Support
  5.  
  6.  
  7. ProDOS 8
  8. #1:    The GETLN Buffer and a ProDOS Clock Card
  9.  
  10. Revised by:    Matt Deatherage                                  November 1988
  11. Revised by:    Pete McDonald                                    November 1985
  12.  
  13. This Technical Note describes the effect of a clock card on the GETLN buffer.
  14. _____________________________________________________________________________
  15.  
  16. ProDOS automatically supports a ThunderClock(TM) or compatible clock card when 
  17. the system identifies it as being installed.  When programming under ProDOS, 
  18. always consider the impact of a clock card on the GETLN input buffer ($200 - 
  19. $2FF).  ProDOS can support other clocks which may also use this space.
  20.  
  21. When ProDOS calls a clock card, the card deposits an ASCII string in the GETLN 
  22. input buffer in the form:  07,04,14,22,46,57.  This string translates as the 
  23. following:
  24.  
  25.     07 = The month, July (01=Jan,...,12=Dec)
  26.     04 = The day of the week, Thurs.(00=Sun,...,06=Sat)
  27.     14 = The date (00 to 31)
  28.     22 = The hour, 10 p.m. (00 to 23)
  29.     46 = The minute (00 to 59)
  30.     57 = The second (00 to 59)
  31.     
  32. ProDOS calls the clock card as part of many of its routines.  Anything in the 
  33. first 17 bytes of the GETLN input buffer is subject to loss if a clock card is 
  34. installed and is called.
  35.  
  36. In general, it has been the practice of programmers to use the GETLN input 
  37. buffer for every conceivable purpose.  Therefore, an application should never 
  38. store anything there.  If your application has a future need to know about the 
  39. contents of the $200 - $2FF space, you should transfer it to some other 
  40. location to guarantee that it will remain intact, particularly under ProDOS, 
  41. where a clock card may regularly be overwriting the first 17 bytes.
  42.  
  43. The ProDOS 8 Technical Reference Manual contains more information on the clock 
  44. driver, including the necessary identification bytes, how the ProDOS driver 
  45. calls the card, and how you may replace this routine with your own.
  46.  
  47.  
  48. Further Reference
  49. o    ProDOS 8 Technical Reference Manual
  50.  
  51.